std::forward_list::before_begin, std::forward_list::cbefore_begin

From Cppreference

C++ Standard Library
Language Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++11) Atomic operations library (C++11) Thread support library (C++11)
Containers library
array (C++11) vector deque forward_list (C++11) list set multiset map multimap unordered_set (C++11) unordered_multiset (C++11) unordered_map (C++11) unordered_multimap (C++11) stack queue priority_queue
std::forward_list
Member functions forward_list::forward_list forward_list::~forward_list forward_list::operator= forward_list::assign forward_list::get_allocator Element access forward_list::front Iterators forward_list::before_begin forward_list::cbefore_begin forward_list::begin forward_list::cbegin forward_list::end forward_list::cend Capacity forward_list::empty forward_list::max_size Modifiers forward_list::clear forward_list::insert_after forward_list::emplace_after forward_list::erase_after forward_list::push_front forward_list::emplace_front forward_list::pop_front forward_list::resize forward_list::swap Operations forward_list::merge forward_list::splice_after forward_list::remove forward_list::remove_if forward_list::reverse forward_list::unique forward_list::sort

iterator before_begin();		(C++11 feature)
const_iterator before_begin() const;		(C++11 feature)
const_iterator cbefore_begin() const;		(C++11 feature)

Returns an iterator to the element before the first element of the container. This element acts as a placeholder, attempting to access it results in undefined behavior. The only usage cases are in functions insert_after(), emplace_after(), erase_after(), splice_after().

Contents 1 Parameters 2 Return value 3 Exceptions 4 Complexity 5 See also

[edit] Parameters

(none)

[edit] Return value

iterator to the element before the first element

[edit] Exceptions

1-3)

[edit] Complexity

Constant

[edit] See also

begin cbegin	returns an iterator to the beginning (public member function)
end cend	returns an iterator to the end (public member function)